<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "https://www.w3.org/TR/html4/loose.dtd">
<html lang="zh-CN"><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta http-equiv="Content-Language" content="zh-CN"><link href="stylesheet.css" media="all" rel="stylesheet" type="text/css">
<title>复合类型</title>
<script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script>
</head><body class="SECT1">
<div>
<table summary="Header navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr><th colspan="5" align="center" valign="bottom">PostgreSQL 8.2.3 中文文档</th></tr>
<tr><td width="10%" align="left" valign="top"><a href="arrays.html" accesskey="P">后退</a></td><td width="10%" align="left" valign="top"><a href="datatype.html">快退</a></td><td width="60%" align="center" valign="bottom">章8. Data Types</td><td width="10%" align="right" valign="top"><a href="datatype.html">快进</a></td><td width="10%" align="right" valign="top"><a href="datatype-oid.html" accesskey="N">前进</a></td></tr>
</table>
<hr align="LEFT" width="100%"></div>
<div class="SECT1"><h1 class="SECT1"><a name="ROWTYPES">8.11. 复合类型</a></h1><a name="AEN5912"></a><a name="AEN5914"></a>
<p><i class="FIRSTTERM">复合类型</i>描述一行或者一条记录的结构；它实际上只是一个字段名和它们的数据类型的列表。PostgreSQL 允许像简单数据类型那样使用复合类型。比如，一个表的某个字段可以声明为一个复合类型。</p>
<div class="SECT2"><h2 class="SECT2"><a name="AEN5919">8.11.1. 声明复合类型</a></h2>
<p>下面是两个定义复合类型的简单例子：</p>
<pre class="PROGRAMLISTING">CREATE TYPE complex AS (
    r       double precision,
    i       double precision
);

CREATE TYPE inventory_item AS (
    name            text,
    supplier_id     integer,
    price           numeric
);</pre>
<p>语法类似于 <tt class="COMMAND">CREATE TABLE</tt> ，只是这里只可以声明字段名字和类型；目前不能声明约束(比如 <tt class="LITERAL">NOT NULL</tt>)。请注意 <tt class="LITERAL">AS</tt> 关键字是很重要的；没有它，系统会认为这是完全不同的 <tt class="COMMAND">CREATE TYPE</tt> 命令，因此你会看到奇怪的语法错误。</p>
<p>定义了类型，我们就可以用它创建表：</p>
<pre class="PROGRAMLISTING">CREATE TABLE on_hand (
    item      inventory_item,
    count     integer
);

INSERT INTO on_hand VALUES (ROW('fuzzy dice', 42, 1.99), 1000);</pre>
<p>或者函数：</p>
<pre class="PROGRAMLISTING">CREATE FUNCTION price_extension(inventory_item, integer) RETURNS numeric
AS 'SELECT $1.price * $2' LANGUAGE SQL;

SELECT price_extension(item, 10) FROM on_hand;</pre>
<p>在你创建表的时候，也会自动创建一个复合类型，名字与表名字相同，表示该表的复合类型。比如，如果我们说过</p>
<pre class="PROGRAMLISTING">CREATE TABLE inventory_item (
    name            text,
    supplier_id     integer REFERENCES suppliers,
    price           numeric CHECK (price &gt; 0)
);</pre>
<p>那么，和前面相同的 <tt class="LITERAL">inventory_item</tt> 复合类型也会作为副产品创建，并且可以和上面一样使用。不过，需要注意一个重要限制：因为现在还没有对复合类型实现约束，所以在表定义中显示的约束<span class="emphasis"><i class="EMPHASIS">并不适用</i></span>于表之外的复合类型。一个部分绕开的办法是使用域类型作为复合类型的成员。</p>
</div>
<div class="SECT2"><h2 class="SECT2"><a name="AEN5934">8.11.2. 复合类型值输入</a></h2><a name="AEN5936"></a>
<p>要以文本常量书写复合类型值，在圆括弧里包围字段值并且用逗号分隔他们。你可以在任何字段值周围放上双引号，如果值本身包含逗号或者圆括弧，你必须用双引号括起(更多细节见下面)。因此，复合类型常量的一般格式如下：</p>
<pre class="SYNOPSIS">'( <tt class="REPLACEABLE"><i>val1</i></tt>, <tt class="REPLACEABLE"><i>val2</i></tt> , ... )'</pre>
<p>一个例子是</p>
<pre class="PROGRAMLISTING">'("fuzzy dice",42,1.99)'</pre>
<p>如果 <tt class="LITERAL">inventory_item</tt> 类型在前面已经定义了，那么这是一个合法的数值。要让一个字段值是 NULL ，那么在列表里它的位置上不要写任何字符。比如，下面这个常量在第三个字段声明一个 NULL ：</p>
<pre class="PROGRAMLISTING">'("fuzzy dice",42,)'</pre>
<p>如果你想要一个空字符串，而不是 NULL ，写一对双引号：</p>
<pre class="PROGRAMLISTING">'("",42,)'</pre>
<p>这里的第一个字段是一个非 NULL 的空字符串，第三个字段是 NULL 。</p>
<p>这些常量实际上只是我们在<a href="sql-syntax-lexical.html#SQL-SYNTAX-CONSTANTS-GENERIC">节4.1.2.5</a>讨论的一般类型常量的一个特殊例子。这些常量一开始只是当作字符串，然后传递给复合类型输入转换器。一个明确的类型声明可能是必须的。</p>
<p>我们也可以用 <tt class="LITERAL">ROW</tt> 表达式语法来构造复合类型值。在大多数场合下，这种方法都比用字符串文本的语法更简单，因为你不用操心多重引号。我们已经在上面使用了这种方法了：</p>
<pre class="PROGRAMLISTING">ROW('fuzzy dice', 42, 1.99)
ROW('', 42, NULL)</pre>
<p>只要你在表达式里有超过一个字段，那么关键字 <tt class="LITERAL">ROW</tt> 就实际上是可选的，所以可以简化为</p>
<pre class="PROGRAMLISTING">('fuzzy dice', 42, 1.99)
('', 42, NULL)</pre>
<p><tt class="LITERAL">ROW</tt> 表达式语法在<a href="sql-expressions.html#SQL-SYNTAX-ROW-CONSTRUCTORS">节4.2.11</a>里有更详细的讨论。</p>
</div>
<div class="SECT2"><h2 class="SECT2"><a name="AEN5955">8.11.3. 访问复合类型</a></h2>
<p>要访问复合类型字段的一个域，我们写出一个点以及域的名字，非常类似从一个表名字里选出一个字段。实际上，因为实在太像从表名字中选取字段，所以我们经常需要用圆括弧来避免分析器混淆。比如，你可能需要从 <tt class="LITERAL">on_hand</tt> 例子表中选取一些子域，像下面这样：</p>
<pre class="PROGRAMLISTING">SELECT item.name FROM on_hand WHERE item.price &gt; 9.99;</pre>
<p>这样将不能工作，因为根据 SQL 语法，<tt class="LITERAL">item</tt> 是从一个表名字选取的，而不是一个域名字。你必须像下面这样写：</p>
<pre class="PROGRAMLISTING">SELECT (item).name FROM on_hand WHERE (item).price &gt; 9.99;</pre>
<p>或者如果你也需要使用表名字(比如，在一个多表查询里)，那么这么写：</p>
<pre class="PROGRAMLISTING">SELECT (on_hand.item).name FROM on_hand WHERE (on_hand.item).price &gt; 9.99;</pre>
<p>现在圆括弧对象正确地解析为一个指向 <tt class="LITERAL">item</tt> 字段的引用，然后就可以从中选取子域。</p>
<p>类似的语法问题适用于在任何地点从一个复合类型值中查询一个域。比如，要从一个返回复合类型值的函数中只选取一个字段，你需要写像下面这样的东西</p>
<pre class="PROGRAMLISTING">SELECT (my_func(...)).field FROM ...</pre>
<p>如果没有额外的圆括弧，会产生一个语法错误。</p>
</div>
<div class="SECT2"><h2 class="SECT2"><a name="AEN5966">8.11.4. 修改复合类型</a></h2>
<p>下面是一些插入和更新复合类型字段的正确语法。首先，插入或者更新整个字段：</p>
<pre class="PROGRAMLISTING">INSERT INTO mytab (complex_col) VALUES((1.1,2.2));

UPDATE mytab SET complex_col = ROW(1.1,2.2) WHERE ...;</pre>
<p>第一个例子省略了 <tt class="LITERAL">ROW</tt> ，第二个使用它；两种方法都行。</p>
<p>我们可以更新一个复合字段的独立子域：</p>
<pre class="PROGRAMLISTING">UPDATE mytab SET complex_col.r = (complex_col).r + 1 WHERE ...;</pre>
<p>请注意，这里我们不需要(实际上是不能)在 <tt class="LITERAL">SET</tt> 后面出现的字段名周围放上圆括弧，但是我们在等号右边的表达式里引用同一个字段的时候却需要圆括弧。</p>
<p>我们也可以声明子域是 <tt class="COMMAND">INSERT</tt> 的目标：</p>
<pre class="PROGRAMLISTING">INSERT INTO mytab (complex_col.r, complex_col.i) VALUES(1.1, 2.2);</pre>
<p>如果我们没有为字段的所有子域提供数值，那么剩下的子域将用 NULL 填充。</p>
</div>
<div class="SECT2"><h2 class="SECT2"><a name="AEN5977">8.11.5. 复合类型输入和输出语法</a></h2>
<p>一个复合类型的文本表现形式包含那些根据独立的子域类型各自 I/O 转换规则解析的项，加上一些表明这是复合结构的修饰。这些修饰由整个数值周围的圆括弧(<tt class="LITERAL">(</tt> 和 <tt class="LITERAL">)</tt>)加上相邻域之间的逗号(<tt class="LITERAL">,</tt>)组成。圆括弧外面的空白被忽略，但是在圆括弧里面，它被当作子域数值的一部分，根据该子域的数据类型，这些空白可能有用，也可能没用。比如，在</p>
<pre class="PROGRAMLISTING">'(  42)'</pre>
<p>里，如果子域类型是整数，那么空白将被忽略，但是如果是文本，那么就不会忽略。</p>
<p>如前面显示的那样，在给一个复合类型写数值的时候，你可以在独立的子域数值周围用双引号包围。如果子域数值会导致复合数值分析器产生歧义，那么你<span class="emphasis"><i class="EMPHASIS">必须</i></span>这么做。特别是子域包含圆括弧、逗号、双引号、反斜杠的场合。要想在双引号括起来的子域数值里面放双引号，那么你需要在它前面放一个反斜杠。同样，在一个双引号括起的子域数值里面的一对双引号表示一个双引号字符，就像 SQL 字符串文本的单引号规则一样。另外，你可以用反斜杠逃逸的方法保护所有可能会当作复合类型语法的数据字符。</p>
<p>一个完全空的子域数值(在逗号或者逗号与圆括弧之间没有字符)表示一个 NULL 。要写一个空字符串，而不是一个 NULL ，写 <tt class="LITERAL">""</tt> 。</p>
<p>假如子域数值是空字符串或者包含圆括弧、逗号、双引号、反斜杠、空白，复合类型输出程序会在子域数值周围放上双引号。这么处理空白不是必须的，但是可以增强易读性。在一个子域数值里面嵌入的双引号和反斜杠将会写成两份。</p>
<div class="NOTE">
<blockquote class="NOTE">
<p><b>【注意】</b>请注意你写的任何 SQL 命令都首先被当作字符串文本解析，然后才当作复合类型。这就加倍了你需要的反斜杠数目。比如，要插入一个包含双引号和一个反斜杠的 <tt class="TYPE">text</tt> 子域到一个复合类型数值里，你需要写</p>
<pre class="PROGRAMLISTING">INSERT ... VALUES (E'("\\"\\\\")');</pre>
<p>字符串文本处理器先吃掉一层反斜杠，这样到达复合类型分析器的东西将变成 <tt class="LITERAL">("\"\\")</tt> 。接着，该字符串传递给 <tt class="TYPE">text</tt> 数据类型的输入过程，变成 <tt class="LITERAL">"\</tt> 。如果我们使用的数据类型对反斜杠也有特殊待遇，比如 <tt class="TYPE">bytea</tt> ，那么我们可能需要在命令里放多达八个反斜杠以获取在存储的复合类型子域中有一个反斜杠。美元符界定(参阅<a href="sql-syntax-lexical.html#SQL-SYNTAX-DOLLAR-QUOTING">节4.1.2.2</a>)可以用于避免双份反斜杠的问题。</p>
</blockquote>
</div>
<div class="TIP">
<blockquote class="TIP">
<p><b>【提示】</b>在 SQL 命令里写复合类型值的时候，<tt class="LITERAL">ROW</tt> 构造器通常比复合文本语法更容易使用。在 <tt class="LITERAL">ROW</tt> 里，独立的子域数值的写法和并非作为复合类型的成员书写的方法一样。</p>
</blockquote>
</div>
</div>
</div>
<div>
<hr align="LEFT" width="100%">
<table summary="Footer navigation table" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr><td width="33%" align="left" valign="top"><a href="arrays.html" accesskey="P">后退</a></td><td width="34%" align="center" valign="top"><a href="index.html" accesskey="H">首页</a></td><td width="33%" align="right" valign="top"><a href="datatype-oid.html" accesskey="N">前进</a></td></tr>
<tr><td width="33%" align="left" valign="top">数组</td><td width="34%" align="center" valign="top"><a href="datatype.html" accesskey="U">上一级</a></td><td width="33%" align="right" valign="top">对象标识符类型</td></tr>
</table>
</div>
</body></html>